HAL SBS Functions

Floating point unit interrupts management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group1

This section provides functions to manage the floating point interrupts:

• Call HAL_SBS_EnableFPUIT() to enable the floating point unit interrupt(s).

• Call HAL_SBS_DisableFPUIT() to disable the floating point unit interrupt(s).

• Call HAL_SBS_IsEnabledFPUIT() to check if the floating point unit interrupt is enabled.

Functions

void HAL_SBS_EnableFPUIT ( uint32_t floating_point )

Enable the floating point unit interrupt(s).

Parameters :

floating_point – This parameter can be one or a combination of the following values:

• HAL_SBS_IT_FPU_IOC

• HAL_SBS_IT_FPU_DZC

• HAL_SBS_IT_FPU_UFC

• HAL_SBS_IT_FPU_OFC

• HAL_SBS_IT_FPU_IDC

• HAL_SBS_IT_FPU_IXC

• HAL_SBS_IT_FPU_ALL

void HAL_SBS_DisableFPUIT ( uint32_t floating_point )

Disable the floating point unit interrupt(s).

Parameters :

floating_point – This parameter can be one or a combination of the following values:

• HAL_SBS_IT_FPU_IOC

• HAL_SBS_IT_FPU_DZC

• HAL_SBS_IT_FPU_UFC

• HAL_SBS_IT_FPU_OFC

• HAL_SBS_IT_FPU_IDC

• HAL_SBS_IT_FPU_IXC

• HAL_SBS_IT_FPU_ALL

hal_sbs_it_fpu_status_t HAL_SBS_IsEnabledFPUIT ( uint32_t floating_point )

Check if the floating point unit interrupt is enabled.

Parameters :

floating_point – This parameter can be one of the following values:

• HAL_SBS_IT_FPU_IOC

• HAL_SBS_IT_FPU_DZC

• HAL_SBS_IT_FPU_UFC

• HAL_SBS_IT_FPU_OFC

• HAL_SBS_IT_FPU_IDC

• HAL_SBS_IT_FPU_IXC

Return values :

hal_sbs_it_fpu_status_t – Floating point interrupt status.

TIM break inputs management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group2

This section provides functions to manage the TIM break inputs:

• Call HAL_SBS_EnableTIMBreakInputs() to enable the TIM break inputs.

• Call HAL_SBS_DisableTIMBreakInputs() to disable the TIM break inputs.

• Call HAL_SBS_IsEnabledTIMBreakInputs() to check if the TIM break inputs is enabled.

Functions

void HAL_SBS_EnableTIMBreakInputs ( uint32_t break_input )

Enable the TIM break inputs.

Note

(*) TIM break inputs disabling can only be done by a hardware reset.

Parameters :

break_input – This parameter can be one or a combination of the following values:

• HAL_SBS_FLASH_ECC_DOUBLE_ERROR

• HAL_SBS_PVD (*)

• HAL_SBS_SRAM_ECC_DOUBLE_ERROR (*)

• HAL_SBS_LOCKUP_OUT (*)

void HAL_SBS_DisableTIMBreakInputs ( uint32_t break_input )

Disable the TIM break inputs.

Parameters :

break_input – This parameter can be one or a combination of the following values:

• HAL_SBS_FLASH_ECC_DOUBLE_ERROR

hal_sbs_tim_break_input_status_t HAL_SBS_IsEnabledTIMBreakInputs ( uint32_t break_input )

Check if the TIM break inputs is enabled.

Parameters :

break_input – This parameter can be one of the following values:

• HAL_SBS_FLASH_ECC_DOUBLE_ERROR

• HAL_SBS_PVD (*)

• HAL_SBS_SRAM_ECC_DOUBLE_ERROR (*)

• HAL_SBS_LOCKUP_OUT (*)

Return values :

hal_sbs_tim_break_input_status_t – TIM break inputs status.

Compensation cell management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group3

This section provides functions to control the compensation cell:

• Call HAL_SBS_SetCompensationCellCodeSrc() to set the compensation cell code source.

• Call HAL_SBS_GetCompensationCellCodeSrc() to get the compensation cell code source.

• Call HAL_SBS_EnableCompensationCell() to enable the I/O compensation cell.

• Call HAL_SBS_DisableCompensationCell() to disable the I/O compensation cell.

• Call HAL_SBS_IsEnabledCompensationCell() to check if the I/O compensation cell is enabled.

Functions

void HAL_SBS_SetCompensationCellCodeSrc ( uint32_t comp_cell , hal_sbs_ccell_code_src_t code_select )

Set the compensation cell code source.

Parameters :

• comp_cell – This parameter has the following value:

  • HAL_SBS_CCELL_VDDIO

• code_select – This parameter can be one of the following values:

  • HAL_SBS_CCELL_CODE_DEFAULT

  • HAL_SBS_CCELL_CODE_CUSTOM

hal_sbs_ccell_code_src_t HAL_SBS_GetCompensationCellCodeSrc ( uint32_t comp_cell )

Get the compensation cell code source.

Parameters :

comp_cell – This parameter can be one of the following values:

• HAL_SBS_CCELL_VDDIO

Return values :

hal_sbs_ccell_code_src_t – Compensation cell code source.

hal_status_t HAL_SBS_EnableCompensationCell ( uint32_t comp_cell )

Enable the I/O compensation cell.

Parameters :

comp_cell – This parameter has the following value:

• HAL_SBS_CCELL_VDDIO

Return values :

• HAL_ERROR – The compensation cell was not enabled within the allowed timeout period.

• HAL_OK – Compensation cell is enabled.

void HAL_SBS_DisableCompensationCell ( uint32_t comp_cell )

Disable the I/O compensation cell.

Parameters :

comp_cell – This parameter has the following value:

• HAL_SBS_CCELL_VDDIO

hal_sbs_ccell_status_t HAL_SBS_IsEnabledCompensationCell ( uint32_t comp_cell )

Check if the I/O compensation cell is enabled.

Parameters :

comp_cell – This parameter can be one of the following values:

• HAL_SBS_CCELL_VDDIO

Return values :

hal_sbs_ccell_status_t – I/O Compensation cell status.

Compensation cell code management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group4

This section provides functions to manage the compensation cell:

• Call HAL_SBS_GetPMOSCompensationCellValue() to get the PMOS compensation value of selected compensation cell.

• Call HAL_SBS_GetNMOSCompensationCellValue() to get the NMOS compensation value of selected compensation cell.

• Call HAL_SBS_SetConfigxMOSCompensationCellCode() to set the compensation cell code.

• Call HAL_SBS_GetConfigxMOSCompensationCellCode() to get the compensation cell code.

Functions

uint32_t HAL_SBS_GetPMOSCompensationCellValue ( uint32_t comp_cell )

Get the PMOS compensation value of the selected compensation cell.

Parameters :

comp_cell – This parameter can be one of the following values:

• HAL_SBS_CCELL_VDDIO

Return values :

uint32_t – Value of the PMOS compensation cell.

uint32_t HAL_SBS_GetNMOSCompensationCellValue ( uint32_t comp_cell )

Get the NMOS compensation value of the selected compensation cell.

Parameters :

comp_cell – This parameter can be one of the following values:

• HAL_SBS_CCELL_VDDIO

Return values :

uint32_t – Value of the NMOS compensation cell.

void HAL_SBS_SetConfigxMOSCompensationCellCode ( uint32_t comp_cell , uint32_t pmos_code , uint32_t nmos_code )

Set the compensation cell code.

Parameters :

• comp_cell – This parameter has the following value:

  • HAL_SBS_CCELL_VDDIO

• pmos_code – PMOS value to be applied to the compensation cell

• nmos_code – NMOS value to be applied to the compensation cell

void HAL_SBS_GetConfigxMOSCompensationCellCode ( uint32_t comp_cell , uint32_t * p_pmos_code , uint32_t * p_nmos_code )

Get the compensation cell code.

Parameters :

• comp_cell – This parameter can be one of the following values:

  • HAL_SBS_CCELL_VDDIO

• p_pmos_code – Pointer to PMOS register of the selected compensation cell

• p_nmos_code – Pointer to NMOS register of the selected compensation cell

NMI double ECC error in FLASH Interface functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group5

This section provides functions to enable/disable the NMI in case of double ECC error in FLASH Interface:

• Call HAL_SBS_FLASH_EnableECCNMI() to enable the NMI in case of double ECC error in FLASH Interface.

• Call HAL_SBS_FLASH_DisableECCNMI() to disable the NMI in case of double ECC error in FLASH Interface.

• Call HAL_SBS_FLASH_IsEnabledECCNMI() to Check if the NMI is Enabled in case of double ECC error in FLASH Interface.

Functions

void HAL_SBS_FLASH_EnableECCNMI ( void )

Enable the NMI in case of double ECC error in FLASH Interface.

void HAL_SBS_FLASH_DisableECCNMI ( void )

Disable the NMI in case of double ECC error in FLASH Interface.

uint32_t HAL_SBS_FLASH_IsEnabledECCNMI ( void )

Check if the NMI is Enabled in case of double ECC error in FLASH Interface.

Return values :

State – of bit (1 or 0).

Hide Protection Level management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group6

This section provides functions to set and get the HDP level value :

• Call HAL_SBS_SetHDPLevelValue() to set the HDP level value.

• Call HAL_SBS_GetHDPLevelValue() to get the HDP level value.

• Call HAL_SBS_SetHDPOBKLevelValue() to set the OBK-HDP level value.

• Call HAL_SBS_GetHDPOBKLevelValue() to get the OBK-HDP level value.

Functions

hal_status_t HAL_SBS_SetHDPLevelValue ( hal_sbs_hdp_level_value_t value )

Set the HDP level value.

Parameters :

value – Value of the HDP level. This parameter can be one of the following values:

• HAL_SBS_HDP_LEVEL_1

• HAL_SBS_HDP_LEVEL_2

• HAL_SBS_HDP_LEVEL_3

Return values :

• HAL_ERROR – Invalid HDP level value not set.

• HAL_OK – Valid HDP level value set correctly.

hal_sbs_hdp_level_value_t HAL_SBS_GetHDPLevelValue ( void )

Get the HDP level value.

Return values :

hal_sbs_hdp_level_value_t – HDPL value.

Core lock registers functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group7

This section provides functions to manage the lock feature :

• Call HAL_SBS_LockCoreRegisters() to lock the Core registers.

• Call HAL_SBS_IsLockedCoreRegisters() to check if the Core registers is locked.

Functions

void HAL_SBS_LockCoreRegisters ( uint32_t core_regs )

Lock the Core registers.

Note

The unlock can only be done with a system reset

Parameters :

core_regs – This parameter can be one or a combination of the following values:

• HAL_SBS_CORE_VTOR_REG

• HAL_SBS_CORE_MPU_REG

• HAL_SBS_CORE_ALL_REGS

hal_sbs_core_reg_lock_status_t HAL_SBS_IsLockedCoreRegisters ( uint32_t core_regs )

Check if the Core registers are locked.

Parameters :

core_regs – This parameter can be one of the following values:

• HAL_SBS_CORE_VTOR_REG

• HAL_SBS_CORE_MPU_REG

Return values :

hal_sbs_core_reg_lock_status_t – SBS Core registers lock status.

Flag management functions

STM32C562xx STM32C5A3xx STM32C542xx

group SBS_Exported_Functions_Group8

This section provides functions to manage the memories erase status feature :

• Call HAL_SBS_IsActiveFlag() to check the memories erase status flags.

• Call HAL_SBS_ClearFlag() to get clear the memories erase status pending flags.

Functions

uint32_t HAL_SBS_IsActiveFlag ( uint32_t flag )

Check if an SBS memories erase status flag is active or not.

Parameters :

flag – This parameter can be one of the following values:

• HAL_SBS_FLAG_ICACHE

• HAL_SBS_FLAG_MEMORIES

Return values :

retrieve – the state of the selected memory flag (1U or 0U).

void HAL_SBS_ClearFlag ( uint32_t flag )

Clear the SBS memories erase status pending flag(s).

Parameters :

flag – This parameter can be one or a combination of the following values:

• HAL_SBS_FLAG_ICACHE

• HAL_SBS_FLAG_MEMORIES

Ethernet functions

STM32C562xx STM32C5A3xx STM32C542xx

Note

This section is not available for STM32C562xx.

Channel Pin Remap functions

STM32C562xx STM32C5A3xx STM32C542xx

Note

This section is not available for STM32C562xx.